home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 041a / bmr_100.zip / BMR.DOC next >
Text File  |  1993-03-30  |  18KB  |  573 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                         B M R
  18.  
  19.                               Broadcast Message Receiver
  20.  
  21.                                          for
  22.  
  23.                                    Netware and OS/2
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.           BMR - Broadcast Message Receiver for Netware and OS/2
  32.           User's Manual
  33.  
  34.           Introduction
  35.           ============
  36.  
  37.           BMR  is an  OS/2 PM  hosted utility for  use with  Novell Netware
  38.           LANs.   It's purpose is to intercept those often annoying "popup"
  39.           messages that result from other users and/or the network software
  40.           "sending"  you   messages.    Instead  of  a   VIO  popup  screen
  41.           interrupting your  work every  time a  message  is received,  BMR
  42.           collects these message and displays  them in a scrollable listbox
  43.           display.
  44.  
  45.           In addition, messages can be sent to one or more users using BMR.
  46.           Users are selected from a "drop down" or  a listbox (depending on
  47.           the  runtime mode selected).  Multiple users and/or groups may be
  48.           targeted  at one  time.   Outgoing messages  are recorded  in the
  49.           receive  listbox for later reference,  and may be  resent if need
  50.           be.
  51.  
  52.           BMR has some useful configuration options, too.  First, there are
  53.           five different interfaces to choose from.  Each interface has the
  54.           same  basic functionality,  but varies  in the  size and  type of
  55.           controls.  You can  change to the "next" interface mode simply by
  56.           pressing  the ">" button.   In addition, an  "Option" button lets
  57.           you control other  features.   You may control  the "beep"  alarm
  58.           that sounds when  new messages are  received.  You  may turn  all
  59.           message reception off, or  simply accept messages but notify  the
  60.           sender that  you are  "away".  The  message that is  "returned to
  61.           sender" is also  configurable, so it's easy to say  what you want
  62.           (for example, "Nick is  away until 12:00".)  Finally,  the amount
  63.           of  information  given to  you when  group  messages are  sent is
  64.           configurable.
  65.  
  66.           Configurable  options are stored in a file called BMR.INI and are
  67.           restored the next time BMR is invoked.
  68.  
  69.           This  IS a shareware package, and does require a registration fee
  70.           if  you choose  to  continue  using  it  after 30  days.      The
  71.           registration fee is currently $15 US for individual users.  For a
  72.           server  license (aimed more at company purchases), the fee is $35
  73.           for  any number of users on a  single server.  When you register,
  74.           you will  be sent the  latest "registered" version of  BMR.  This
  75.           version  will no longer display the startup screen present in the
  76.           non-registered version.
  77.           ----------------------------------------------------------------
  78.           IMPORTANT:  READ THE READ.ME FILE FOR NEW FEATURES AND BUG FIXES
  79.           ----------------------------------------------------------------
  80.  
  81.  
  82.  
  83.           ----------------------------------------------------------------
  84.           BMR User's Guide                                       Page  1
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.           DISCLAIMER OF WARRANTY
  94.           ======================
  95.  
  96.           THIS SOFTWARE AND  MANUAL ARE  DISTRIBUTED AND SOLD  "AS IS"  AND
  97.           WITHOUT WARRANTIES  AS TO  PERFORMANCE OF MERCHANTABILITY  OR ANY
  98.           OTHER WARRANTIES WHETHER  EXPRESSED OR IMPLIED.   BECAUSE OF  THE
  99.           VARIOUS  HARDWARE  AND  SOFTWARE  ENVIRONMENTS  INTO  WHICH  THIS
  100.           PROGRAM  MAY  BE PUT,  NO WARRANTY  OF  FITNESS FOR  A PARTICULAR
  101.           PURPOSE IS OFFERED.
  102.  
  103.           GOOD OPERATING PROCEDURE DICTATES  THAT ANY PROGRAM BE THOROUGHLY
  104.           TESTED WITH NON-CRITICAL  DATA BEFORE  RELYING ON IT.   THE  USER
  105.           MUST ASSUME THE ENTIRE  RISK OF USING THE PROGRAM.  ANY LIABILITY
  106.           OF  THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT
  107.           OR REFUND OF PURCHASE PRICE. 
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.           ----------------------------------------------------------------
  145.           BMR User's Guide                                       Page  2
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.           Major Features
  154.           ==============
  155.  
  156.           o    OS/2 PM specific.   Other  platforms may be  supported if  a
  157.                need is present.
  158.  
  159.           o    Multithreaded design.
  160.  
  161.           o    Received messages  are captured into  a scrollable  listbox.
  162.                The listbox is cleared only by user command.
  163.  
  164.           o    Multiple modes - several dialog box front ends are available
  165.                to accommodate as many users as possible.  Pass BMR a simple
  166.                single digit number parameter  from 1 to 5 (e.g.,  "BMR 2").
  167.                Modes can be switched  from within BMR, also, and  your last
  168.                selected mode will  be remembered and  set as your  start-up
  169.                default.
  170.  
  171.           o    Focus-sensitive beeper  alerts you  to new messages  ONLY if
  172.                BMR does not have the "focus", if desired.  In addition, the
  173.                alarm can be made to always beep, or to never beep.
  174.  
  175.           o    Sends messages, too.  Target users/groups are selectable via
  176.                a  drop down  list  or  full listbox.    You may  also  send
  177.                messages to the console.
  178.  
  179.           o    Resend  any  previously  sent/received  message   simply  by
  180.                clicking on any message displayed in the received listbox.
  181.  
  182.           o    A configurable "return to sender" message may be sent to any
  183.                user  trying  to send  you messages.    It's easy  to inform
  184.                people that you are away for some time or in a meeting.  You
  185.                may also simply "cast off" and choose to receive no messages
  186.                (sending is *always* possible).
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.           ----------------------------------------------------------------
  206.           BMR User's Guide                                       Page  3
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.           Installing BMR
  215.           ===============
  216.  
  217.           Unpack   the  BMR_100.ZIP  file  into  an  appropriate  directory
  218.           ("\BMR", for instance).  All BMR files should be kept together in
  219.           the same directory.
  220.  
  221.           Unpacking BMR_100.ZIP  is all that's involved  in installing BMR.
  222.           We suggest  creating an icon for BMR and placing it either on the
  223.           WPS desktop or in your startup folder.
  224.  
  225.           BMR  does require  a PC  running  OS/2 and  attached to  a Novell
  226.           Netware network.  At this  time, BMR is a 16-bit  application and
  227.           thus,  it should  be  functional with  OS/2  1.3.   This  remains
  228.           untested.   The development and test system consisted of OS/2 2.0
  229.           and 2.1 betas attached to a Novell 3.11 network server.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.           ----------------------------------------------------------------
  267.           BMR User's Guide                                       Page  4
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.           Using BMR for the First Time
  276.           =============================
  277.  
  278.           BMR's  user interface consists mainly of one screen.  This screen
  279.           contains a user selection list, the received message  listbox and
  280.           4 buttons.  This simplicity makes BMR easy to use, even without a
  281.           manual.
  282.  
  283.           User List
  284.           ---------
  285.           The User  List contains the  names of  all account  names on  the
  286.           server, as well as the console and any groups.  Any messages sent
  287.           from BMR  will be  received  by the  users  selected here.    The
  288.           behavior of this listbox  depends on the mode of BMR.  In mode 2,
  289.           the User  List is a  standard drop-down  combo box, in  which one
  290.           user name may be selected.   In modes 1 and 3 - 5,  the User List
  291.           is a multiple-selection  list box,  in which any  number of  user
  292.           names  may  be selected.   All  selected  users will  receive any
  293.           messages sent from BMR.
  294.  
  295.           Send Box
  296.           --------
  297.           This box is where you type messages to be sent.  A message may be
  298.           up  to  50  characters  long.   If  you  try  to  type  beyond 50
  299.           characters, BMR  will beep  and stop  accepting keystrokes.   The
  300.           Send Box keeps  the focus even when you click  other areas of BMR
  301.           with the mouse.
  302.  
  303.           Receive Box
  304.           -----------
  305.           This  list box  displays all  messages sent  or received  by BMR.
  306.           Messages that you sent will be displayed in the form:
  307.  
  308.                Message Text->YourAccountName
  309.  
  310.           while messages received by you will be displayed in the form:
  311.  
  312.                YourAccountName: Message Text
  313.  
  314.           In  addition  to  these messages,  you  will  also receive  error
  315.           reports.  If a user is  not logged on, not accepting messages, or
  316.           away, you will be notified in this list box.
  317.  
  318.           Selecting  any message in the  Receive Box with  the mouse causes
  319.           the text to be copied into the send box, so that you can resend a
  320.           message or forward one.  The User Name will be  stripped from the
  321.           message, and only the text copied.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.           ----------------------------------------------------------------
  328.           BMR User's Guide                                       Page  5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.           The OPTION Button
  337.           =================
  338.           Pressing this button will display the Configuration Options entry
  339.           screen.   There are three  switches and  one text entry  field on
  340.           this  screen.   These  fields provide  flexible control  over the
  341.           message  "beeper", your message receiving state and the amount of
  342.           detail BMR  displays back  to you  as  groups are  expanded.   In
  343.           addition, you may define a short  text string to send to any user
  344.           that attempts to contact you while you are marked as unavailable.
  345.           Each field on this screen is described below.
  346.  
  347.           Beeper
  348.           ------
  349.           This is a checkbox field that controls the "beeper" alarm that is
  350.           sounded  when any new message is received.  It initially defaults
  351.           to  "checked".  Clicking  on the button  or its  text will toggle
  352.           through the three possible states:  clear, checked or solid.   If
  353.           this  box is clear, beeping is totally disabled and you will hear
  354.           no  audible signal  as messages  are received.   If  checked, the
  355.           beeper is enabled in "no focus"  mode.  If a message is received,
  356.           BMR will sound  the alarm  if and only  if it  does not have  the
  357.           current  WPS focus  (you're  currently working  with a  different
  358.           application).    If marked  solid, BMR  will  always beep  upon a
  359.           message  reception, whether BMR is currently the active window or
  360.           not.
  361.  
  362.           Return to Sender
  363.           ----------------
  364.           This checkbox  allows for  three different  modes.   The  initial
  365.           default mode  is for  the checkbox to  be clear, which  is normal
  366.           receive  mode.    All  incoming  messages will  be  received  and
  367.           recorded in the  message listbox.   If this box  is checked,  BMR
  368.           goes  into  "user  is away"  mode.    All  incoming messages  are
  369.           accepted  and  displayed in  the  message listbox,  but  a return
  370.           message is automatically returned to  the user who originated the
  371.           message.  This message  identifies you by user name,  followed by
  372.           the text that you define in the next "text entry" field.  If this
  373.           checkbox is  marked as solid,  you are in  "cast off" mode.   The
  374.           result is  the same  as  if you  had used  the Netware  "Castoff"
  375.           command line utility.   All  users sending you  messages will  be
  376.           notified  that you  are  not accepting  messages.   Netware  will
  377.           reject the messages before they  get to BMR, so you will  not see
  378.           any messages appearing in the received message listbox.
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.           ----------------------------------------------------------------
  389.           BMR User's Guide                                       Page  6
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.           Return to Sender Notice
  398.           -----------------------
  399.           This  is a text entry field that  identifies the message you wish
  400.           to send when you are marked as unavailable.  BMR will append this
  401.           message to your user name, identifying you as  the "sender".  For
  402.           example, if you fill this field with "is unavailable until 3:30",
  403.           anyone  sending you  a line  message will  immediately be  sent a
  404.           message that states (using "Nick" as the login name):
  405.  
  406.                "Nick - is unavailable until 3:30".
  407.  
  408.           This message is send automatically if and only if the "Return  to
  409.           sender" checkbox is in checked mode.
  410.  
  411.  
  412.           Report Group Expansion
  413.           ----------------------
  414.           This checkbox is used  to indicate how much information  you wish
  415.           to  see reported to the receive listbox when groups are expanded.
  416.           If left clear (unchecked), no expansion information is displayed.
  417.           Group messages are sent  "blind" and you are not informed  of the
  418.           user names that were sent to, and all error reporting (e.g., "not
  419.           logged  in") is  suppressed.   If the  checkbox is  checked, then
  420.           groups are still not reported by individual names unless an error
  421.           occurs.   In  this case, users  that are  not logged  on, are not
  422.           accepting message, or are unable to see your message for whatever
  423.           reason  are listed in  the receive listbox.   If this checkbox is
  424.           solid, then complete  reporting is  enabled.  In  this mode,  the
  425.           "send" to each user  is reported to the receive  listbox, as well
  426.           as any error conditions that occur.
  427.  
  428.  
  429.           The CLEAR Button
  430.           ================
  431.           This button allows you to clear both the SEND message box and the
  432.           RECEIVED listbox.  When you press CLEAR, BMR checks to see if any
  433.           text is  currently present  in the  SEND message  entry box.   If
  434.           something is there, BMR clears only that text.  If no text exists
  435.           in the SEND message box, BMR clears the RECEIVED message listbox.
  436.           Simply double clicking on  the CLEAR button insures  a completely
  437.           clear state.
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.           ----------------------------------------------------------------
  450.           BMR User's Guide                                       Page  7
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.           The MODE Button [>]
  459.           ===================
  460.           This button may be pressed  to change the main BMR dialog  box to
  461.           the next "mode".  For example, if you load BMR  initially with no
  462.           parameters, MODE 1 is invoked.  You may press the MODE button one
  463.           time to see MODE  2, then press it again to see MODE 3.  When the
  464.           last MODE is reached, BMR will set the mode back to MODE 1.
  465.  
  466.           Each dialog mode works in basically the same way.  The difference
  467.           is mostly in the overall size of the dialog box and the fields it
  468.           contains.   Once you find  the mode  option that  suites you  the
  469.           best,  simply exit  BMR with  that  mode active.   BMR  saves the
  470.           current  mode and screen position  in the BMR.INI  file, and will
  471.           restore your previous state upon reentry.
  472.  
  473.           NOTE:  If a mode parameter is specified to BMR  on startup (e.g.,
  474.           "BMR 3"), then this mode overrides the mode saved in BMR.INI.
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.           ----------------------------------------------------------------
  511.           BMR User's Guide                                       Page  8
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.           CONTACTING THE AUTHORS
  520.           ======================
  521.  
  522.           Authors:  John Lathem and Nick Knight
  523.  
  524.           You    may contact  either  one  of us  in  a  number   of  ways.
  525.           Unfortunately, we can't provide a phone number at this time.
  526.  
  527.             US Mail:     John Lathem                   Nick Knight
  528.                          4278 W. 223rd Street          1823 David Ave.
  529.                          Cleveland, Ohio  44126        Parma, Ohio 44134
  530.  
  531.             Fax:              (216) 734-1836 (ZSpace - John Lathem)
  532.  
  533.             Fido netmail:     1:157/200 to "Nick Knight" or "John Lathem"
  534.  
  535.             Fido Echomail:    Echomail messages are discouraged.
  536.  
  537.             Direct BBS:       You can leave  a message to  either of us  on
  538.                               the  PC-Ohio  BBS  (216) 381-3320.    This is
  539.                               Fidonet system 1:157/200 and  Fidonet netmail
  540.                               can be sent to this address.
  541.  
  542.             Internet mail:    john.lathem@pcohio.com
  543.                               nick.knight@pcohio.com
  544.  
  545.             Compuserve:       You can contact Nick  Knight here.  Send mail
  546.                               to user ID - 76066,1240.
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.           ----------------------------------------------------------------
  572.           BMR User's Guide                                       Page  9
  573.